Skip to content

docs: 补齐 VSeed 贡献与 PR 工作流说明 - #596

Merged
youngwinds merged 3 commits into
mainfrom
codex/vseed-workflow-docs
Nov 10, 2026
Merged

youngwinds merged 3 commits into
mainfrom
codex/vseed-workflow-docs

Conversation

@Rui-Sun

@Rui-Sun Rui-Sun commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

对照 VChart/VTable 补齐开发者与 Agent 的完整协作入口:README、贡献指南、开发约定、PR 模板、Playwright 用例指南和 BugServer Photo 管理员协作说明。

  • 说明提交前检查、真实交互/业务断言、全量官方基线比较和负对照要求。
  • 补齐已启用范围与起点、各 PR 状态处理、当前提交有效批准、人工合入和异常恢复。
  • 明确 Photo report-only、流程完成不等于 Photo 全通过、不得自动更新基准或绕过去重。
  • 纯文档变更;未修改产品源码、测试、依赖、CI、服务配置或发布策略。

新增中英文贡献指南,保留覆盖率、生成和网站验收要求;明确 VBI 是规范仓库、main + packages/vseed/ 准入及 Node24 产品运行包。

验证:

  • 检查全部改动文件的相对链接/锚点:36 项,无缺失。
  • node packages/vseed/scripts/visual-test.mjs --list 成功,与指南的用例 ID 和覆盖范围一致。
  • 核对 package scripts、CI job/step、用例导出接口及当前部署快照;git diff --check 通过。
  • 修改文档的仓库 oxfmt 格式检查通过。

未运行产品构建、单测、覆盖率、浏览器/视觉比较或手动模型/Photo 批次,原因是此次仅修改文档。提交后既有 CI 和自动工作流照常执行,结果以其当前版本报告为准。正式启用快照不代表首条自然 PR 或 24 小时/3 次执行观察已完成。

VisActor 工作流(CN):completed

当前提交:528c14e1d7588ad9acfd8756804751ad68101474

三项检查建议与 BugServer 人工确认

@visactor-review-bot

visactor-review-bot Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

VisActor 工作流

结论:流程已完成。
当前提交:528c14e;比较基线:81ee3ba。
环境:CN;更新时间:2026-11-10T06:19:16.747Z。

检查项 状态 关键结果
CR ✅ passed 待处理 0;接受风险 0 查看结果
单测 ✅ passed 必要单测 job 必须实际执行并成功 查看结果
Playwright ✅ passed 截图 4;匹配 4;差异 0(已解释 0);错误 0
Photo(原 BugServer / UNIC) ✅ passed 用例 808;截图 824;匹配 824;差异 0(已解释 0);错误 0

Photo 独立报告:流程完成不代表 Photo 通过。 Photo 自动执行并展示原始结果;差异解释仅作非阻断建议,强制门禁和标准图更新保持关闭,需管理员人工核查。

已人工合入;Photo 自动标准图更新已暂停,未满足的合入前条件不会由事后批准追认。
Bot 仅提供 CR、单测、Playwright 三项检查建议,不强制阻止合入。

Photo 执行明细

Photo 原始执行:completed;结果:passed;缺少基准 0;等待 0;运行中 0;不完整 0;创建未知 0。

Photo 差异解释(非阻断建议)

差异共 0 项;已逐项分析 0 项;未分析 0 项。
分析状态:全部差异已分析。以标准图为认可效果;仅解释差异和可能原因,不判断可接受、不建议更新基准。结论仅适用于下列已分析任务,不代表其余差异已验证,不改变 Photo 原始结果。

图片差异解释(0 项)

暂无已解释差异。

合入后 Photo 基准更新清单

自动标准图更新已暂停。

版本与合入后状态

当前提交:528c14e1d7588ad9acfd8756804751ad68101474;比较基线:81ee3baa4f43f80643a1eeac673d8981e048e139。

合入后状态:skipped。

CN 结果仅证明上述实际范围;完整报告和原始差异继续保留。

@visactor-review-bot visactor-review-bot Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

最新复查提交: 528c14e

未发现可确认的新问题;此前报告的 PR 模板链接问题已在当前版本修复。

Comment thread .github/PULL_REQUEST_TEMPLATE.md Outdated

### ☑️ Self-Check before Merge

Read [PR checks and merge process](../CONTRIBUTING.md#pr-checks-and-merge-process). Target `main`; the advisory workflow accepts eligible same-repository, non-draft PRs created after 2026-11-06 22:05 Asia/Shanghai and touching packages/vseed/.

@visactor-review-bot visactor-review-bot Bot Nov 6, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] PR 模板中的相对链接在 PR 描述中指向错误路径

模板内容会被复制进 PR 描述;此时链接不再位于 .github/PULL_REQUEST_TEMPLATE.md。例如从 /VisActor/VBI/pull/596 解析这里的 ../CONTRIBUTING.md,路径变成 /VisActor/VBI/CONTRIBUTING.md,而仓库文件页应位于 /VisActor/VBI/blob/main/CONTRIBUTING.md。同一模板的 ../packages/...、./PULL_REQUEST_TEMPLATE/pr_cn.md 以及中文版模板的 ../../... 也受影响。建议在 PR 模板里使用仓库文件的绝对 GitHub URL。此处已核对 URL 路径解析,未能在联网的 GitHub PR 页面直接点击验证。


已确认修复 (528c14e): 已复查原触发条件:默认英文模板及中文版模板复制进 PR 描述后,全部模板链接现均为指向 VisActor/VBI/blob/main 下文件的绝对 URL,不再根据 /pull/596 解析相对路径。贡献指南文件和对应目标已存在;最小 Node 校验确认英文 3 个、中文 2 个模板链接均为绝对 URL,因此原先点击贡献指南或中文版模板时的路径错误已消失。

@youngwinds
youngwinds merged commit 1cac2ef into main Nov 10, 2026
6 checks passed
@youngwinds
youngwinds deleted the codex/vseed-workflow-docs branch November 10, 2026 06:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants